ADVANCE SUBMISSION OF ITEM DATA (INTEGRATION OPTIONS)

The information system of Bulgarian Posts allows for the advance submission of data for items, which are to be sent. In this way, the acceptance of items at post offices is much faster. Upon physical acceptance of the items at a post office, the submitted data can be edited by our employee. The data, which was submitted upon acceptance of the item at the post office, is considered real. All prices are calculated at the moment of acceptance of the item, according to the concluded contract. Discounts are calculated at the time of invoicing and are also individual, according to the contract.  

For the purpose of submitting information for the items, you will receive an e-mail, containing the GUID of the contract. The GUID is submitted, regardless of the working mode chosen by you, so that the individual prices and discounts can be applied.  

You can submit the data in one of the following two ways:

1. Via file 
   The file can be in an Excel (xls or xlsx) or a csv-format. For csv-format, you need to specify the encoding, with which the file was saved - UTF-8 or Windows 1251.
   The file is submitted to our system via an FTP server.
   There is no limit to the number of files submitted per day or the number of items in one file.
   When submitting data via FTP, you will receive the username by e-mail, and the password to access the FTP server of Bulgarian Posts via SMS.  
   
   The file ImportFromFile.xlsx contains the fields that need to be submitted. They depend on the services that you wish to use. Bulgarian Posts will assist you in identifying these fields by removing the redundant ones.  
   
   
2. Via API
   In this case you can use methods for:

• Nomenclatures (Countries, Towns, Post Offices with geo-location, etc.).
• Portal (Register/Edit/Change/Check item data, Calculate item prices, Generate bills of lading, etc.).
• Tracking (item status by barcode, by order number or status of an entire session of items).

A description of the API methods, along with documentation and examples, can be found at: https://api.bgpost.bg

The valid field names when submitting item data via the API are identical to the names described in the ImportFromFile.xlsx file. Optional fields are not submitted. The required and optional fields and their length, when working with the API, are the same as described in the ImportFromFile.xlsx file. Bulgarian Posts will assist you in specifying these fields by removing the redundant ones.

The standard order for creating a item using the API methods is:

• A new session is created using the portalUserGUID provided to the client. The session is required to retrieve general information about the items attached to it (Requests from the Session section).
• Items are created with the portalSessionGUID obtained in the session (Requests from the Parcel section).
• A label can be generated with the obtained parcelGUID (Requests from the Waybill section).  

Both methods can be used together – for example, item data can be submitted via a file and tracked via an API.  

Submitting data via a file or an API does not oblige you to provide the items to Bulgarian Posts. That is, you can develop the integration and submit item data for testing before starting real work.

For online sellers